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Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp) . 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3 GPP and ETSI identities can be found under 
http://webapp.etsi.org/key/queryform. asp . 
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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part of a TS-family covering the 3^^ Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.121: Advanced Alarm Management (AAM) Integration Reference Point (IRP): Requirements 

32.122: Advanced Alarm Management (AAM) Integration Reference Point (IRP): Information Service 

(IS) 

32.123: Advanced Alarm Management (AAM) Integration Reference Point (IRP): Common Object 

Request Broker Architecture (CORB A) Solution Set 

32.125: Advanced Alarm Management (AAM) Integration Reference Point (IRP): extensible 

Markup Language (XML) file format definition 

The Itf-N interface is built up by a number of IRPs and a related Name Convention, which realise the functional 
capabilities over this interface. The basic structure of the IRPs is defined in 3GPP TS 32.150 [1]. 

For the purpose of AAM IRP, see TS 32.121 [2] 
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Scope 



The purpose of Advanced Alarm Management (AAM) IRP is to define an interface through which an IRPManager can 
categorize alarm notifications. 

The present document is the AAM IRP XML file format definition, whose semantics are specified in AAM IRP 
Information Service (3GPP TS 32.122 [3]). 

This file format definition specification is related to TS 32.122 vS.l.O. 



2 References 

The following documents contain provisions that, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document 
(including a GSM document), a non-specific reference implicitly refers to the latest version of that document in 
the same Release as the present document. 

[1] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 

and definitions". 

[2] 3GPP TS 32.121: "Telecommunication management; Advanced Alarm Mangement (AAM) 

Integrations Reference Point (IRP); Requirements ". 

[3] 3GPP TS 32.122: "Telecommunication management; Advanced Alarm Mangement (AAM) 

Integrations Reference Point (IRP); Information Service (IS)". 

[4] W3C REC-xml-20001006: "Extensible Markup Language (XML) 1 .0 (Second Edition)" . 

[5] W3C REC-xmlschema-0-20010502: "XML Schema Part 0: Primer". 

[6] W3C REC-xmlschema-1-20010502: "XML Schema Part 1: Structures". 

[7] W3C REC-xmlschema-2-20010502: "XML Schema Part 2: Datatypes". 

[8] W3C REC-xml-names- 199901 14: "Namespaces in XML". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: 

IRP: See 3GPP TS 32.150 [1]. 

IRPAgent: See 3GPP TS 32.150 [1]. 

IRPManager: See 3GPP TS 32.150 [1]. 

Alike Alarm: Two alarms are considered alike, if the corresponding alarm notifications are issued by the same object 
instance with the same alarmType, same perceivedSe verity, same probableCause and same specificProblem (if present). 
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Lower Edge of Time Window: The point in time which determines the begin of a time span. 

Upper Edge of Time Window: The point in time which determines the end of a time span. 

XML file: file containing an XML document 

XML document: composed of the succession of an optional XML declaration followed by a root XML element 

NOTE: See [4] ; in the scope of the present document. 
XML declaration: it specifies the version of XML being used 

NOTE: See [4]. 

XML element: has a type, is identified by a name, may have a set of XML attribute specifications and is either 
composed of the succession of an XML start-tag followed by the XML content of the XML element followed by an 
XML end-tag, or composed simply of an XML empty-element tag; each XML element may contain other XML 
elements 

NOTE: See [4]. 

empty XML element: having an empty XML content; an empty XML element still possibly has a set of XML attribute 
specifications; an empty XML element is either composed of the succession of an XML start-tag directly followed by 
an XML end-tag, or composed simply of an XML empty-element tag 

NOTE: See [4]. 

XML content (of an XML element): empty if the XML element is simply composed of an XML empty-element tag; 
otherwise the part, possibly empty, of the XML element between its XML start-tag and its XML end-tag 

XML start-tag: the beginning of a non-empty XML element is marked by an XML start-tag containing the name and 
the set of XML attribute specifications of the XML element 

NOTE: See [4]. 

XML end- tag: the end of a non-empty XML element is marked by an XML end-tag containing the name of the XML 
element 

NOTE: See [4]. 

XML empty-element tag: composed simply of an empty-element tag containing the name and the set of XML attribute 
specifications of the XML element. 

NOTE: See [4]. 

XML attribute specification: has a name and a value 

NOTE: See [4]. 

DTD: defines structure and content constraints to be respected by an XML document to be valid with regard to this 
DTD 

NOTE: See [4]. 

XML schema: more powerful than a DTD, an XML schema defines structure and content constraints to be respected 
by an XML document to conform with this XML schema; through the use of XML namespaces several XML schemas 
can be used together by a single XML document; an XML schema is itself also an XML document that shall conform 
with the XML schema for XML schemas 

NOTE: See [5], [6] and [7]. 

XML namespace: enables qualifying element and attribute names used in XML documents by associating them with 
namespaces identified by different XML schemas 

NOTE: See [8], in the scope of the present document. 
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XML complex type: defined in an XML schema; cannot be directly used in an XML document; can be the concrete 
type or the derivation base type for an XML element type or for another XML complex type; ultimately defines 
constraints for an XML element on its XML attribute specifications and/or its XML content 

NOTE: See [5], [6] and [7]. 

XML element type: declared by an XML schema; can be directly used in an XML document; as the concrete type of 
an XML element, directly or indirectly defines constraints on its XML attribute specifications and/or its XML content; 
can also be the concrete type or the derivation base type for another XML element type 

NOTE: See [5], [6] and [7]. 



3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 

AAM Advanced Alarm Management 

AAMRule Advanced Alarm Management Rule 

CM Configuration Management 

EM Element Manager 

IOC Information Object Class 

IRP Integration Reference Point 

IS Information Service 

Itf-N Interface N 

MIB Management Information Base 

NE Network Element 

XML extensible Markup Language 



AAM IRP XML Definitions 



4.1 



AAM IRP notifications XIVIL definition structure 



Currently there are no AAM IRP notifications defined in 3GPP TS 32.122 [3]. 



4.2 



AAM IRP XML Sciiema for notifications 



Currently there are no AAM IRP notifications defined in 3GPP TS 32.122 [3]. 
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4.3 AAM IRP XML Schema for lOCs 

<?xml version="l . 0" encoding="UTF-8" ?> 

3GPP TS 32.125 AAMIRP IOC XML Schema 
aamlRPIOCs.xsd 
- - > 

<schema xmlns :xaa="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 125#aamIRPIOCs" 
xmlns="http : //www. w3 . org/2 l/XMLSchema" 

targetNamespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 125#aamIRPIOCs" 
elementFormDefault= "qualified" attributeFormDef ault= "unqualified" > 
<simpleType name="AdvancedAlarmManagementRuleIdentif ier" > 
<restriction base="string" > 

<length value="64"> 
</restriction> 
</simpleType> 

<simpleType name="AdvancedAlarmManagementRuleType" > 
<restriction base="string" > 

<enumeration value="THRESHOLD_RULE"/> 
<enumeration value="TRANSIENT_RULE"/> 
<enumeration value="TOGGLE_RULE"/> 
<enumeration value="VENDOR_SPECIFIC_RULE"/> 
< /restrict ion> 
</simpleType> 
<simpleType name="TimeSpan" > 

<restriction base="string" > 

<length value="3"> 
< /restrict ion> 
</simpleType> 

<complexType name="AAMRuleParameterListForTransientRule" > 
<sequence> 

<element name="TimeSpan" type="xaa :TimeSpan"/> 
</ sequence > 
</complexType> 

<simpleType name="AlarmOccurenceThreshold" > 
<restriction base="string" > 

< length value="3"> 
< /restrict ion> 
</simpleType> 

<simpleType name="SlidingTimeWindow" > 
<restriction base="string" > 

<length value="3"> 
< /restrict ion> 
</simpleType> 

<complexType name="AAMRuleParameterListForThresholdRule" > 
<sequence> 

<element name="AlarmOccurenceThreshold" type="xaa : AlarmOccurenceThreshold"/> 
<element name="SlidingTimeWindow" type="xaa : SlidingTimeWindow"/> 
</ sequence > 
</complexType> 
<complexType name="AAMRuleParameterListForToggleRule" > 
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<sequence> 

<element name= " AlarmOccurenceThreshold" type= "xaa : AlarmOccurenceThreshold" /> 
<element name= " SlidingTimeWindowTogglingStarted" type= "xaa : SlidingTimeWindow" /> 
<element name="SlidingTimeWindowTogglingSettled" type="xaa : SlidingTimeWindow" /> 
</ sequence > 
</complexType> 

<simpleType name="VendorSpecif icParameterldentif ier" > 
<restriction base="string" > 

<length value="64"> 
< /restrict ion> 
<simpleType name="VendorSpecif icParameterValue" > 
<restriction base="string" > 

<length value="64"> 
< /restrict ion> 
<complexType name="VendorSpecif icParameter" > 
<sequence> 

<element name= "VendorSpecif icParameterldentif ier " 
type="xaa: VendorSpec if icParameterldentif ier" /> 

<element name=" VendorSpecif icParameterValue" type="xaa : VendorSpecif icParameterValue"/> 
</ sequence > 
</complexType> 

<complexType name="AAMRuleParameterListForVendorSpecif icRule" > 
<sequence> 

<element name=" VendorSpecif icParameter" type="xaa : VendorSpecif icParameter" 
maxOccurs= " unbounded " / > 
</ sequence > 
</complexType> 

<complexType name= " AdvancedAlarmManagementRuleParameterList " > 
<choice> 

<element name="AAMRuleParameterListForTransientRule" 
type="xaa:AAMRuleParameterListForTransientRule"/> 

<element name="AAMRuleParameterListForThresholdRule" 
type="xaa : AAMRuleParameterListForThresholdRule"/> 

<element name="AAMRuleParameterListForToggleRule" 
type="xaa:AAMRuleParameterListForToggleRule"/> 

<element name="AAMRuleParameterListForVendorSpecif icRule" 
type= "xaa :AAMRuleParameterListForVendorSpecif icRule" /> 
</choice> 
</complexType> 
<simpleType name= " Filter" > 

<restriction base="string" > 

<length value="256"> 
< /restrict ion> 
</simpleType> 

<!-- Attributes of the advancedAlarmManagementRule IOC --> 
<element name="advancedAlarmManagementRuleIdentif ier" 
type="xaa:AdvancedAlarmManagementRuleIdentif ier"/> 

<element name= " advancedAlarmManagementRuleType " type= "xaa : AdvancedAlarmManagementRuleType " / > 
<element name="advancedAlarmManagementRuleParameterList " 
type="xaa : AdvancedAlarmManagementRuleParameterList "/> 

<element name=" filter" type= "xaa : Filter" /> 
</ schema > 
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Annex A (informative): 
XIVIL schema electronic files 



The electronic files corresponding to the XML schemas defined in the present document are available in native form in 
the following archive: 

http://www.3gpp.org/ftp/specs/archive/32_series/32125/schema/32125-800-XMLSchema.zip 
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